1 Администрирование системы

1.1 Страница Администрирование

Чтобы попасть на данную страницу на верхней панели "Хроматэк Навигатор" выберите закладку Администрирование".

Здесь расположены следующие функции:

	Учётные записи.
	Журнал аудита
	Протокол квалификации IQ/OQ/PQ. Также называется протоколом валидации.
	Меню установки сертификата HTTPS.
	Обновление программного обеспечения.
	Grafana. Инструмент разработчика для просмотра логов.

В правой части страницы расположен блок информации о сертифицированных модулях.

Ниже выводится дата сборки локального сервиса приборов. Она должна соответствовать дате сборки сервиса приборов (главного), которая отображается в блоке "Информация" на рабочем столе "Хроматэк Навигатор".

	Кнопка возле заголовка "Состояние" меню сброса состояния переменных.

 

1.2 Учётные записи

Учётные записи необходимы для разграничения привилегий доступа пользователей.

С создания учётных записей пользователей начинается работа с ПО "Хроматэк Аналитик".

Нажмите на кнопку "Администрирование" на верхней панели "Хроматэк Навигатор".

	На странице "Администрирование" нажмите на кнопку "Учётные записи".
	Добавьте новую учётную запись пользователя.

 

1.2.1 Роли пользователей

По умолчанию доступны четыре роли:

• Админ

• Эксперт

• Пользователь

• Гость

Вы можете изменить набор привилегий для каждой из них, а также создать новые роли, если есть такая необходимость.

• Перейдите на закладку "Роли".

• Выберете роль для настройки.

• Включите/выключите привилегии пользователя в соответствии с его правом доступа.

	При необходимости добавьте новую роль.
	…или удалите существующую.

• Задайте название роли.

Все изменения сохраняются сразу же.

Таблица 1.1 – Привилегии пользователей

Привилегии	Роли по умолчанию
	Админ	Эксперт	Пользователь	Гость
Администрирование системы	+
Доступ ко всем соединениям	+
Изменение соединений	+	+	+
Изменение проектов	+	+	+
Обновление прошивок	+	+
Изменение конфигурации инструмента	+	+
Изменение плана анализов	+	+
Изменение метода инструмента	+	+
Изменение метода обработки	+	+
Изменение информации о пробе	+	+	+
Изменение пользовательских параметров	+	+
Изменение данных карт Шухарта	+	+	+
Изменение каналов	+	+	+
Ручная разметка пиков	+	+	+
Изменение метода хроматограммы	+	+	+
Изменение параметров удерживания в хроматограмме	+	+	+
Удаление данных	+

 

 

1.2.2 Добавление и редактирование пользователя

• Перейдите на закладку "Пользователи".

	Нажмите на кнопку "Новый пользователь".
	…или выберите пользователя в списке и нажмите на кнопку "Редактировать".

• В обоих случаях откроется диалог редактирования данных пользователя.

• Задайте имя и фамилию пользователя (оно будет отображаться на верхней панели "Хроматэк Навигатор").

• Задайте логин. Он не отображается в интерфейсе. Может быть сохранён в браузере. Логин не должен совпадать с именем пользователя, должен содержать только латинские буквы и цифры.

• Задайте пароль. Он также не отображается в интерфейсе и может быть сохранён в браузере. Пароль должен содержать только латинские буквы и цифры.

• Выберите роль.

• Нажмите "Применить". Если эта кнопка недоступна – значит вы не задали или задали неправильно какие-либо данные.

Учётная запись не может быть отредактирована никаким другим способом.

Для смены учётной записи нажмите на кнопку с именем и в появившемся меню выберите "Выход". Откроется страница входа в систему.

 

 

1.3 Идентификация программного обеспечения

Программа обработки хроматографических и масс-спектрометрических анализов является составной частью программного комплекса "Хроматэк Аналитик". По традиции она тоже называется "Аналитик" и в свою очередь состоит из клиентской и серверной части.

На панели "Информация" рабочего стола "Хроматэк Навигатор" перечислены основные модули ПО и даты сборки каждого из них. С помощью этой информации можно оценить, насколько актуально ПО. Обновления выходят не реже, чем раз в полгода.

Метрологически-значимые модули ПО располагаются в серверной части.

В состав метрологически-значимой части ПО входят файлы:

Файл	Версия	Хэш по алгоритму MD5
Analytic3Core.dll	3.0.0.2	183cfadacae1872240739164795ebcb4
Chromatec.Analytic31.Gost31371_7_2020.dll	1.0.2210.21	785f319ac4379775d37162131f6bc771
Chromatec.Analytic31.Gost31369_2021.dll	1.0.2304.28	8fc9f1b0984c50c24f510c8bf9b87f1b
Chromatec.Analytic31.Gost34704_2020.dll	1.0.2304.20	9acca8c5f2b704c49a69708eb737a7e4
Chromatec.Analytic31.Gost34723_2021.dll	1.0.2305.12	c894d5ca5b319ab264133f715a129eb6

Однозначная идентификация ПО производится путем определения хэш-кода защищенных модулей по алгоритму MD5 и версий файлов.

Результат контроля выводится в приложении "Навигатор" на странице Администрирование.

"Навигатор" сравнивает значения контрольных сумм метрологически-значимых модулей с эталонными значениями. При совпадении соответствующая строка выделяется зеленым цветом. При несовпадении, красным.

Пользователь может проверить хэш-коды с помощью сторонних сервисов и утилит. Например, при наличии доступа в интернет можно воспользоваться онлайн-сервисом md5file.com. Предварительно нужно скачать файл метрологически-значимого модуля с сервера на локальный компьютер. Для этого нужно щёлкнуть мышью по названию модуля (это ссылка). Скачав модуль, загрузите его в онлайн-сервисе и сразу получите значение хэш-кода.

При работе в ОС Linux хэш-код можно проверить встроенной командой md5sum.

Например, на Linux Astra выполняются такие команды (после каждой нажимайте ENTER):

cd /opt/analutic/app/aspnet/calc
sudo md5sum Chromatec.Analutic31.Gost3136g_2E21.dll

Вам будет предложено ввести пароль администратора компьютера, после чего в терминале появится строка:

bag6Bf3fBbdB7b1a64422efddee41ccd Chromatec.Analutic31.Gost31369_2021.dll

Здесь первый элемент строки – искомый хэш-код. Сравните его со значением в сертификате.

Сертификаты на программное обеспечение доступны в библиотеке.

Хэш-код уникален для каждого файла и зависит от его содержимого. В случае любого изменения файла, алгоритм MD5 не даст прежний код. Таким образом, сравнив рассчитанный хэш-код с заранее известным эталоном, можно сделать вывод о том, подвергался файл изменению или нет. В случае, если какой-либо файл будет изменен, его реальный хэш-код не будет совпадать с контрольным.

Возможность штатного (санкционированного) изменения расчётных формул, алгоритмов и какого-либо другого функционала в "Хроматэк Аналитик" отсутствует. Пользователь при необходимости может добавить свои дополнительные расчёты с помощью редактора формул пользователя, но не может изменить существующие, в том числе реализованные в соответствии с методикой поверки.

Отдельной защиты расчётных формул, алгоритмов и другого функционала "Хроматэк Аналитик" не предусмотрено. Защита реализована для всех метрологически-значимых файлов.

 

1.4 Аудит

Для автоматического протоколирования всех событий прибора и планов анализов, действий оператора по обработке хроматограммы, в соответствии с принципами GLP/GMP в "Хроматэк Аналитик" ведётся журнал аудита.

Кратко о GLP/GMP:

Good Laboratory Practice (Good Manufactory Practice), GLP/GMP – Правила надлежащей лабораторной (производственной) практики, формально определяются как система качества, касающаяся организационного процесса и условий, в которых функционирует лаборатория.

Система GLP/GMP действует уже более 30 лет. Первоначально она, была разработана и введена в действие американским Управлением пищевой и медицинской промышленности (FDA) применительно к производствам, использующим токсичные вещества, с целью устранить имевшиеся несоответствия в нормативной документации. Нормы GLP/GMP стали обязательными для всех компаний в США, а впоследствии – и в странах, экспортирующих в США свою продукцию. Затем усилиями Организации экономического сотрудничества и развития (OECD/ОЭСР) эти нормы стали распространяться в международном масштабе. В частности, в Германии требования GLP/GMP являются обязательными при разработке любых новых видов химической продукции.

Главная задача GLP/GMP – обеспечить возможность полного прослеживания и восстановления всего хода исследования. Контроль качества призваны осуществлять специальные органы, периодически инспектирующие лаборатории на предмет соблюдения нормативов GLP/GMP.

GLP/GMP устанавливает очень строгие требования к ведению и хранению документации – значительно более жесткие, чем европейские стандарты серии EN 45000. Сферы применения норм GLP/GMP устанавливаются законодательно. В первую очередь это относится к разработке новых химических веществ, получению и использованию токсичных веществ и к здравоохранению.

В Российской Федерации принципы надлежащей лабораторной практики регулируются межгосударственным стандартом ГОСТ 33044-2014.

В фармакологии GLP регулируется положениями раздела 21 главы 11 Свода федеральных законоположений (CFR) Управления по санитарному надзору за качеством пищевых продуктов и медикаментов США (европейский аналог – глава 4, приложения 11 Нормативно-правовой базы обращения лекарственных средств в рамках Законодательства Европейского Союза).

Программное обеспечение "Хроматэк Аналитик" соответствует требованиям раздела 21 CFR часть 11.

В "Хроматэк Аналитик 4.0" аудит состоит из двух частей:

• Основной журнал. Активен всегда. Выключить его нельзя. В нём фиксируются события, происходящие в "Хроматэк Навигатор" и "Панели управления".

• Аудит хроматограммы. По умолчанию этот журнал выключен. При включении в нём фиксируются события в хроматограммах и методах.

	Чтобы просмотреть журналы аудита, нажмите кнопку "Аудит" на странице "Администрирования" программы "Хроматэк Навигатор".

 

1.4.1 Основной журнал

Сразу доступен при переходе на соответствующую вкладку

	Чтобы настроить период показа записей, а также задать условия их отображения нажмите на боковой панели кнопку "Фильтр".

В диалоге настройки запроса записей вы можете выбрать условия показа записей аудита:

• для выбранных пользователей (отображаются идентификаторы пользователей),

• для выбранных источников (здесь отображаются модули ПО "Хроматэк Аналитик"),

• для выбранных типов действий,

• для выбранных IP-адресов.

 

1.4.2 Аудит хроматограмм

• Если нужно вести аудит хроматограмм – включите соответствующую опцию (во вкладке "Аудит хроматограмм").

• Перейдите на закладку "Аудит хроматограмм". Данные будут появляться при настройке методов и обработке хроматограмм.

• Выберите проект в таблице слева.

• Выберите аудит методов или хроматограмм с помощью переключателя в заголовке средней таблицы.

• Выберите идентификатор метода или хроматограммы в средней таблице.

• В правой таблице появится список всех изменений, произошедших с данным методом или хроматограммой.

	С помощью кнопки "Отчёт" вы можете создать отчёт по текущему журналу.

 

 

1.5 Сертификат HTTPS

Сертификат HTTPS (он же сертификат SSL, Secure Sockets Layer) обеспечивает доступ к сайту по протоколу HTTPS с шифрованием данных.

SSL-сертификат подтверждает ваш домен или организации и позволяет установить безопасное соединение. Он содержит индивидуальный ключ вашего домена, с помощью которого информация между сервером и клиентом (вами) зашифровывается.

Процесс работает следующим образом:

• Браузер пытается подключиться к веб-сайту, защищенному с помощью SSL.

• Браузер запрашивает идентификацию у веб-сервера.

• В ответ веб-сервер отправляет браузеру копию своего SSL-сертификата.

• Браузер проверяет, является ли этот SSL-сертификат доверенным. Если это так, он сообщает об этом веб-серверу.

• Веб-сервер возвращает подтверждение с цифровой подписью и начинает сеанс, зашифрованный с использованием SSL.

Зашифрованные данные используются совместно браузером или сервером и веб-сервером.

Если для сайта, каковым является веб-приложение "Хроматэк Аналитик" нет сертификата, то при обращении по адресу https://<имя сайта или IP компьютера> будет выдано предупреждение:

Браузер проверяет, является ли полученный от сервера сертификат доверенным, с помощью корневого сертификата, установленного в системе. Таким образом для обеспечения подключения по HTTPS нам потребуются два сертификата:

• Сертификат сайта. Его сгенерирует серверное ПО "Хроматэк Аналитик". Для этого данному ПО нужно сообщить адрес сайта.

• Корневой сертификат. Его нужно установить в операционной системе, причём для Linux и Windows процедуры установки различны, а также имеет значение, какой используется браузер (для Mozilla Firefox процедура установки отличается от браузеров на движке Chromium).

	Для того, чтобы обеспечить доступ к сайту по защищённому протоколу HTTPS в "Навигаторе" на странице "Рабочий стол" нажмите на кнопку "Сертификат HTTPS". Откроется меню. С его помощью вы должны будете выполнить две операции:
	Настроить имя сервера. Требуются права администратора!
	Скачать и установить корневой сертификат.

Рассмотрим эти действия по порядку:

	Настроить имя сервера. При выборе данного пункта меню вам будет предложено ввести имя сервера, для которого будет сгенерирован сертификат. При обращении по протоколу https к этому адресу будет оказано доверие и соединение с данным сервером будет рассматриваться, как защищённое.

 

	Скачать корневой сертификат. Выберите этот пункт меню и сохраните файл analytic_root_ca.crt в любом месте диска. Далее нужно установить его в браузер. В зависимости от используемого браузера и операционной системы существует несколько способов установки:

 

1.5.1 Установка сертификата безопасности в браузер Mozilla Firefox

Установка выполняется одинаково в Windows и Linux

 

1.5.2 Установка сертификата безопасности в Windows

Показана установка сертификата для браузеров на базе движка Chromium (Google Chrome, Chromium, Opera, Edge, Яндекс-Браузер).

 

 

1.6 Обновление программного обеспечения

Новые сборки ПО, выкладываемые на сайте для скачивания, содержат исправление ошибок и новые функциональные возможности. Даже если вас в работе ПО всё устраивает, рекомендуется следить за актуальностью ПО и обновлять его по мере появления новых сборок не реже раза в год.

Вы можете скачать файл обновления на сайте или получить его от службы технической поддержки "Хроматэк".

На странице скачивания файлов доступны дистрибутивы:

• analytic4-setup-linux.iso. Полный дистрибутив для установки на Linux.

• analytic4-setup-windows.exe. Полный дистрибутив для установки на Windows.

Скачайте необходимый дистрибутив и установите, как описано в Инструкции по установке.

 

Также вы можете получить от службы техподдержки пакет обновления ПО. Обычно он меньше полного дистрибутива, и выпускается для оперативного обновления каких-либо ошибок.

Для установки оперативного обновления выполните действия:

	В "Навигаторе" на странице "Администрирование" нажмите на кнопку "Обновление программного обеспечения". Откроется страница, как на рисунке ниже.

Нажмите на поле "Файл не выбран" и выберите на компьютере файл .tar, который вы получили от службы техподдержки.

После его выбора сразу начинается установка обновления. После распаковки файлов выполняется рестарт обновлённых модулей. Окно принимает вид, как на рисунке ниже (в данном примере обновлялись только модули p4 и p4s – сервис управления приборами).

Обновление выполнено успешно, если в журнале появилось сообщение:

Open browser and type in address bar http://localhost

Теперь можете продолжить работу.

 

 

2 Сервис

2.1 Фиксация времени удерживания

В процессе старения хроматографической колонки может потребоваться её замена. При этом иногда бывает важно обеспечить неизменность времен удерживания компонентов, заданных в настройках метода. Однако две колонки никогда не повторяют друг друга абсолютно идеально.

Для того, чтобы сохранить времена удерживания в неизменности нужно скорректировать (подобрать) давление в колонке таким образом, чтобы времена удерживания компонентов не изменились.

Для выполнения процедуры фиксации времён удерживания вы должны записать 5 хроматограмм со следующими условиями:

• Базовое давление в колонке, установленное по рабочей методике.

• Давление больше базового на 10%.

• Давление больше базового на 20%.

• Давление меньше базового на 10%.

• Давление меньше базового на 20%.

	Дальнейшая работа выполняется в "Хроматэк Навигатор".

• Выберите ранее записанные хроматограммы. На их основе будет построена функция зависимости давления от времени (полином третьей степени).

• Задайте интересующее время. По функции будет рассчитано давление, которое необходимо для того, чтобы интересующий пик вышел в заданное время.

• Выберите соединение и метод инструмента. Вы можете сохранить новое значение давления в исходном методе или задать новое имя метода.

 

2.2 Калькуляторы

	На рабочем столе "Хроматэк Навигатор" нажмите кнопку "Калькуляторы" для перехода на страницу вспомогательных калькуляторов различных величин.

 

2.2.1 Капиллярная колонка

Калькулятор расчёта параметров потока газа по капиллярной колонке.

 

2.2.2 Порт ввода (испаритель)

Калькулятор объёма паров, образующихся при испарении растворителей в пространстве лайнера.

 

2.2.3 Переключатель Дина

Калькулятор параметров системы переключения потоков Дина. Рассчитывает параметры:

• Длина капилляра.

• Давление на входе в первую колонку.

• Давление поддува.

 

2.2.4 Конвертер величин

Конвертер, позволяющий преобразовать различные физические величины из одних единиц измерения в другие.

 

 

2.3 Диагностика

	Различные диагностические сервисы доступны в меню кнопки "Диагностика" на рабочем столе "Навигатора".

 

2.3.1 Диагностические логи

В случае возникновения каких-либо проблем вы можете обратиться в техподдержку и у вас могут запросить диагностические логи. Чтобы скачать их выполните действия:

	На рабочем столе "Навигатора" нажмите кнопку "Диагностика".
	Выберите пункт "Скачать диагностические логи".

• В появившемся диалоге отметьте сервисы, логи которых попросила у вас техподдержка.

• Выберите день, за которых хотите получить логи.

• Нажмите "OK".

Далее вам будет предложено сохранить на компьютере файл *.tar.gz. Перешлите его в техподдержку.

 

2.3.2 Диагностические графики

Данный сервис позволяет преобразовать диагностический лог "Панели управления" в графики зависимости изменения диагностических параметров хроматографа во времени.

Интерактивный график, снабжённый маркером, позволяет отслеживать изменение важных параметров оборудования для поиска проблем.

	На рабочем столе "Навигатора" нажмите кнопку "Диагностика" или щёлкните правой кнопкой мыши по виджету соединения.
	Выберите пункт "Диагностические графики".
	Выберите интервал дат, за который нужно показать диагностику.
	Включите маркер. Его можно перемещать мышью. Он показывает абсолютное время.

На левой панели выберите те сигналы, которые нужно показать на графике.

	Выбранные сигналы можно сохранить в файле .json…
	… и загрузить из такого файла для просмотра. Файл можно отправить разработчику.

 

2.3.3 Удалённая диагностика

Для предоставления доступа службе технической поддержки вы должны скачать кроссплатформенную программу "RuDesktop":

	Скачать для Astra Linux
	Cкачать для Alt Linux
	Скачать для РЕД ОС
	Скачать для Ubuntu
	Скачать для Windows 64-бит
	Скачать для Windows 32-бит

Запустите скаченный файл и установите программу.

Откройте ей с помощью главного меню (например, в Astra Linux она доступна в меню "Сеть").

После запуска в левой части окна вы увидите ID и пароль. Сообщите их оператору техподдержки.

 

 

2.4 Сервисные операции

При работе с Linux рекомендуется изучить полезные команды данной операционной системы.

 

2.4.1 Резервное копирование

Рекомендуется периодически сохранять все накопленные данные в резервной копии.

Чтобы выполнить резервное копирование всех данных (учётные записи, настройки соединений, хроматограммы, отчёты, журналы аудита и т.д.) выполните следующие действия:

 

Данные хранятся на компьютере с Linux (сервер или автономный компьютер)

В командной строке выполните команду:

sudo /opt/analytic/vol-backup.sh

После того, как скрипт завершит работу, архивы с сохранёнными данными будут доступны в папке: /opt/analytic/vol

Скопируйте все файлы из этой папке на другой компьютер.

Чтобы восстановить данные из резервной копии, скопируйте ранее сохранённые файлы в ту же самую папку /opt/analytic/vol

В командной строке выполните команду:

sudo /opt/analytic/vol-restore.sh

 

Данные хранятся в Windows

При работе в Windows с виртуальной машиной папка данных находится на физической машине. Расположение папки данных выбирается на этапе установки ПО. По умолчанию путь к этой папке – c:\Analytic 4

Просто скопируйте всю папку и сохраните на другом компьютере.

Чтобы восстановить данные из резервной копии – просто скопируйте в указанную папку все папки и файлы их того места, где они были сохранены.

 

2.4.2 Сброс учётных записей

Сброс учётных записей проводится в случае утери логина-пароля пользователя, имеющего привилегию управления учётными записями.

Выполнить данную операцию может только администратор компьютера с соответствующим допуском к файловой системе сервера.

Ниже показано, как сбросить учётные записи в Linux.

В командной строке выполните команду:

/opt/analytic/recovery-admin.sh

Перезапустится сервер авторизации и в консоль будет выведен текст:

Use empty login and following password to recovery accounts management
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VySWQiOiIiLCJyb2xlSWQiOiIiLCJwZXJtaXNzaW9ucyI6WyJhZG1pbiJdLCJleHAiOjE2ODkwNzM4NDQsIm5iZiI6MTY4OTA3MzU0NH0.KKKdnKGOX8OreqFfbxAGgcKrvuuYrxcwiDQ1dl32t8s

Здесь вторая строка – токен временного доступа (действителен в течение 5 минут). Выше приведён пример, в вашем случае код будет другой.

Скопируйте его и введите в качестве пароля в окне авторизации.

После входа в систему перейдите на страницу управления пользователями и задайте новый пароль администратора.

 

2.4.3 Сброс состояния переменных

Некоторые настройки состояния "Навигатора" запоминаются на локальном компьютере:

• Последняя просмотренная новость.

• Последняя просмотренная папка отчётов.

• Последний просмотренный справочник компонентов.

• Последняя просмотренная локация в истории измерений.

• Последний редактированный метод карт Шухарта.

• Последний редактированный протокол квалификации.

• Последняя настройка фиксации времён удерживания.

Эти настройки хранятся на локальном компьютере, т.е. если пользователь войдёт в свою учётную запись на другом компьютере, то состояние данных переменных будет другим.

	Эти настройки можно сбросить. Для этого на странице "Администрирование" нажмите на кнопку справа от заголовка "Состояние" и выберите переменную.

 

2.4.4 Выключение сервиса обновлений

Обычно обновить программное обеспечение может любой пользователь с правами администратора.

Если системный администратор хочет запретить такую возможность (чтобы обновлять ПО мог только специально уполномоченный человек), сервис обновлений можно выключить.

Для этого нужно в терминале Linux на компьютере, где установлено ПО выполнить команду:

sudo /opt/update/stop.sh